home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS24.ADF / Sectorama / Sectorama.DOC < prev    next >
Text File  |  1988-04-16  |  7KB  |  154 lines
  1. ***************************************************************************
  2. *                               SECTORAMA                                 *
  3. *                          Disk Sector Utility                            *
  4. *                      By Talin a.k.a. David Joiner                       *
  5. *                                                                         *
  6. *  IMPORTANT NOTE: This program is freely copyable and distributable,     *
  7. *  courtesy of David Joiner and MicroIllusions. It is NOT Public Domain.  *
  8. *  All copyrights are reserved by the author. You may give copies of this *
  9. *  program to anyone you wish but you may not sell it.                    *
  10. *                                                                         *
  11. ***************************************************************************
  12.     This program is designed to help Amiga users recover lost or damaged
  13. data from floppy or hard drives, or to repair a damaged volume.
  14.  
  15. The Obligatory Gratitude Clause.
  16.  
  17. If you like this program and find it useful and worthwhile, you can do one
  18. of several things.
  19.  
  20.     1) You can do absolutely nothing. That's OK.
  21.     2) If you are a developer, you can send be something you have 
  22.     done or are working on. I would like that very much.
  23.     3) If you are not a developer, but have lots of neat public 
  24.     domain software, you could send me something neat. Don't send 
  25.     me anything pirated or I'll just erase it.
  26.     4) If all else fails send me a thank-you note or other 
  27.     comments.
  28.  
  29.     My Address is:
  30.         David Joiner
  31.         17428 Chatsworth
  32.         Granada Hills, CA 91344
  33.  
  34. Don't send me any money.  I don't have time to run a business, and it's
  35. really not worth the effort.  I make enough money writing other kinds of
  36. software (games, creative tools) and we just aren't set up to market any
  37. kind of programming utilities (different kind of tech support, etc).
  38.  
  39. The reason this program was written is because I had six hard-drive
  40. failures over the course of four months (three different units, two
  41. different manufacturers) and several times got myself into situations where
  42. I just HAD to recover a file from a completely scrambled disk.  Since none
  43. of the then-current sector editors would work with hard drives, SECTORAMA
  44. was born.
  45.  
  46. Note that this is not a cracking program.  I don't even know how to write
  47. one of those (disk interfacing was never one of my areas of interest, I'm
  48. basically a graphics and user-interface type).
  49.  
  50. One other note:  Sectorama requires the font TOPAZ-11. Make sure this is in
  51. your current fonts directory or the program won't work.
  52.  
  53. How to use Sectorama:
  54.  
  55. from the CLI, type:
  56.  
  57.         Sec <device>
  58.  
  59. Where <device> is df0:, df1:, dh0:, hd0:, or whatever.  SECTORAMA in it's
  60. current form should work with virtually any AmigaDOS device that has a
  61. block size of 512 bytes.
  62.  
  63. The program will open up a high-res interlaced screen and displays what it
  64. thinks is the root block for that device.  You will notice that one of the
  65. longwords in the block is highlighted.  The highlighting can be moved
  66. around with the mouse or arrow keys, allowing you to select any of the
  67. longwords in the block.
  68.  
  69. Other information about the current block is displayed around the various
  70. parts of the screen, including block number, file name (if applicable),
  71. track/cylinder number, driver name, unit number, etc.  Not all of these
  72. fields are editable in the current version, and some never will be.
  73.  
  74. At the bottom of the page shows 10 numbers labeled 'History'. This is a
  75. list of the last 10 sectors you looked at.  In future versions, you will be
  76. able to click on one of these and go to that sector, but this feature is
  77. not implemented yet.
  78.  
  79.     At the top right is a list of keyboard commands you can enter:
  80.  
  81.     J) Jump - read in the sector number indicated by the contents of the
  82. currently selected longword.
  83.  
  84.         R) Root - go to the root block.
  85.         P) Parent - go to this sector's parent, if possible.
  86.         C) Chain - go to the next sector on the hash chain, 
  87.             if possible
  88.         X) Extention - go to this block's extention block, 
  89.                 if possible.
  90.         H) Header - go to the Header of this data block.
  91.         D) Go to the next data block.
  92.         L) Show the results of the last sector search (see below)
  93.         E) Edit, in hex, the contents of the sector. you may 
  94.             type values in directly. 
  95.             ESCAPE key returns to normal mode.
  96.         A) ASCII Edit, same as Edit, but in ASCII rather than hex.
  97.         K) Compute new checksum for this block.
  98.         U) Update - write this block back to the disk.
  99.         W) Write the data portion of this block to the 
  100.             save file (see below)
  101.  
  102.     Sector Search - 
  103.  
  104. The Sector search pull-down menu allows you to search the entire volume,
  105. sector by sector, looking for certain criteria.  The criteria can be:
  106.  
  107.         1) Filename with wildcards.
  108.         2) Parent block.
  109.         3) Header block.
  110.  
  111. Thus, you can search for all files that fit the pattern "*.c", or all files
  112. that have a parent of 409. This is useful for finding sectors that have
  113. become 'de-linked' from the AmigaDOS filing system.
  114.  
  115. The output of the search looks just like a regular sector filled with
  116. sector keys - you can use the JUMP command to go to any of those keys.  The
  117. result of the search is not destroyed by this action and can be brought up
  118. later using the option 'Last Search'.
  119.  
  120.     Save File -
  121.  
  122. You can open a save file on another disk and save the DATA PORTION of any
  123. sector onto it.  Each write is appended onto the last, thus if your file is
  124. TOTALLY trashed, you can at least get parts of it back (the parts you can
  125. find).
  126.  
  127. Use the 'Open' pull down menu to open the file and the 'Close' to close it.
  128. The 'W' key writes the current sector to the save file.  I have not tested
  129. this function, so be careful with it.
  130.  
  131.     Verify and Repair -
  132.  
  133. These functions aren't finished yet.  Eventually they will perform
  134. DiskDoctor-like functions, except under close user control.
  135.  
  136.     Compute Hash Function -
  137.  
  138. This pull-down menu allows you to type a file or directory name, and it
  139. will set the position of the highlighted region based on the hash value of
  140. that name.  Then, all you need do is hit 'J' (Jump) to go to the hash chain
  141. containing that block, and hit 'C' (Chain) until you get to the entry you
  142. want.
  143.  
  144.     Good Luck!
  145.                   ____
  146.                    /__ /-
  147.                   //-////\/
  148.  
  149. P.S. I have found that since SEC works with anything MOUNTED, it will work
  150. on the VD0:, this offers alot of options.  For one you can modify VD0:,
  151. then do a Diskcopy from VD0:  to you disk for fast disk minipulation, I see
  152. this as a fast way to speed up alot of work that to date has had to be done
  153. in slow-mo.  
  154.